Embabel Agent Documentation/com.embabel.agent.api.tool

Package-level declarations

Types

data class AgenticTool(val definition: Tool.Definition, val metadata: Tool.Metadata = Tool.Metadata.DEFAULT, val llm: <Error class: unknown class> = LlmOptions(), val tools: List<Tool> = emptyList(), val systemPromptCreator: SystemPromptCreator = { defaultSystemPrompt(definition.description) }) : Tool

An agentic tool that uses an LLM to orchestrate other tools.

ConditionalReplanningTool

class ConditionalReplanningTool(val delegate: Tool, decider: ReplanDecider) : DelegatingTool

Tool decorator that executes the wrapped tool, then conditionally triggers replanning based on the result.

MatryoshkaTool

interface MatryoshkaTool : Tool

A tool that contains other tools, enabling progressive tool disclosure.

ReplanContext

data class ReplanContext(val result: Tool.Result, val agentProcess: AgentProcess, val tool: ToolInfo)

Context provided to ReplanDecider for making replanning decisions.

ReplanDecider

fun interface ReplanDecider

Functional interface for deciding whether to trigger replanning based on tool results.

ReplanDecision

data class ReplanDecision constructor(val reason: String, val blackboardUpdater: BlackboardUpdater = BlackboardUpdater {})

Decision returned by ReplanDecider to indicate whether replanning is needed.

ReplanningTool

class ReplanningTool constructor(val delegate: Tool, reason: String, blackboardUpdater: ReplanningToolBlackboardUpdater = ReplanningToolBlackboardUpdater { bb, content -> bb.addObject(content) }) : DelegatingTool

Tool decorator that executes the wrapped tool, adds its result to the blackboard, then throws ReplanRequestedException to terminate the tool loop and trigger replanning.

ReplanningToolBlackboardUpdater

fun interface ReplanningToolBlackboardUpdater

Callback to update the blackboard with tool result content. Defined as a fun interface for Java interoperability.

SystemPromptCreator

typealias SystemPromptCreator = (AgentProcess) -> String

Create a system prompt given the current AgentProcess as context.

Tool

interface Tool : ToolInfo

Framework-agnostic tool that can be invoked by an LLM. Adapters in SPI layer bridge to Spring AI ToolCallback or LangChain4j ToolSpecification/ToolExecutor.

ToolInfo

interface ToolInfo

Tool information including definition and metadata, without execution logic.

TypeBasedInputSchema

class TypeBasedInputSchema(type: Class<*>) : Tool.InputSchema

InputSchema implementation that generates JSON schema from a Class type. Uses reflection to extract properties and their types.